IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/u_man/cat1/kunarc.z/kunarc

Text File | 2002-10-03 | 12.9 KB | 331 lines

     KKKKUUUUNNNNAAAARRRRCCCC((((1111))))       KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))       KKKKUUUUNNNNAAAARRRRCCCC((((1111))))



     NNNNAAAAMMMMEEEE
          kunarc, karc -  K-AShare
          AppleSingle/AppleDouble/BinHex/MacBinary converter

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          kkkkuuuunnnnaaaarrrrcccc [ -_t_r_U ] [ -_f _o_u_t_f_i_l_e ] _i_n_f_i_l_e...
          kkkkaaaarrrrcccc [ -_t_r_A_C_D_M ] [ -_f _o_u_t_f_i_l_e ] _i_n_f_i_l_e...

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          These utility programs let the user convert between various
          Macintosh archival formats and the K-AShare file format.
          The supported archive formats are AppleSingle, AppleDouble,
          BinHex, CAP-AUFS 3.0, Helios Ethershare, MacBinary, TOPS
          (version 2 or later), and IPT uShare 4.1.  These formats are
          used to encode Macintosh specific information (file type and
          creator, resource fork etc.)  into one or more files that
          can be stored on non-Macintosh file systems. BinHex also
          encodes files into ASCII, so that they can be transferred
          via e-mail (i.e. it is similar to _u_u_e_n_c_o_d_e(_1) ). AppleDouble
          is used by some other AppleShare emulators to store
          Macintosh files on Unix filesystems (e.g. A/UX, GatorShare,
          and NFS/Share).  AppleSingle is used by AppleLink to attach
          files to e-mail messages.

          _K_a_r_c creates archive files from K-AShare files, _k_u_n_a_r_c
          creates K-AShare files from archive files.

          BinHex files usually have a .hqx file suffix.  AppleDouble
          format uses two files. For instance, for a file named foo,
          only the macintosh data fork will be stored in the file
          named foo. The resource fork, file creator, type,
          modification date, etc. are stored in a file named %foo.
          _K_u_n_a_r_c should be run on the file that starts with the '%'
          character.

          Helios Ethershare and IPT uShare files have a .rsrc
          subdirectory which contains the resource fork of the file
          contained in the upper directory. Helios Ethershare files
          with no dataforks only have an entry in this .rsrc
          subdirectory.  Using _k_u_n_a_r_c on IPT uShare requires using the
          -U option.  _k_u_n_a_r_c should be run given the name of the .rsrc
          subdirectory, and will then convert all files in the
          subdirectory.  A side effect of running _k_u_n_a_r_c on Helios
          Ethershare and IPT uShare files is that filenames with 8 bit
          characters (accents  and the like) will get renamed using
          Xinet's 8 bit character mapping.

          Helios EtherShare and IPT uShare file systems should also
          have their directory names changed using _k_u_n_a_r_c with the -h
          option.  See the examples.

          MacBinary files usually have a .bin suffix.  The _k_u_n_a_r_c



     Page 1                                          (printed 5/4/100)






     KKKKUUUUNNNNAAAARRRRCCCC((((1111))))       KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))       KKKKUUUUNNNNAAAARRRRCCCC((((1111))))



          utility supports BinHex 4.0 and MacBinary I & II files. Note
          that AppleSingle files received from AppleLink via UNIX mail
          must be run through _u_u_d_e_c_o_d_e first.  _K_u_n_a_r_c does support
          compressed AppleLink enclosures, but the AppleLink software
          or Stuffit Expander must be used to uncompress the resulting
          file.

          _K_u_n_a_r_c will use the file name recorded in the archive file,
          for every _i_n_f_i_l_e that is not preceded by an _o_u_t_f_i_l_e
          argument.

          If you don't use the remove _i_n_f_i_l_e option with _k_a_r_c, you
          must specify an _o_u_t_f_i_l_e.

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
          ----ffff   Use the next argument as the name of _o_u_t_f_i_l_e. If
               _o_u_t_f_i_l_e does not contain a path name, the current
               working directory will be used (rather than any path
               name that may be contained in _i_n_f_i_l_e). If this option
               is  omitted, we try to determine the output filename
               from _i_n_f_i_l_e (and _o_u_t_f_i_l_e will be placed in the same
               directory as _i_n_f_i_l_e). If _o_u_t_f_i_l_e is given as `-', karc
               writes to the standard output.

          ----rrrr   Remove _i_n_f_i_l_e after converting it.

          ----hhhh   Convert _i_n_f_i_l_e Helios EtherShare or IPT uShare
               directory names, and all subdirectory names, to use
               Xinet's 8 bit character encoding scheme.  This option
               should be run by itself either before or after
               converting all the files from Helios EtherShare or IPT
               uShare format to Xinet format.  See the examples below.

          ----tttt   Set the tolerant flag. When this flag is set, kunarc
               tries to handle apparently invalid files. This is
               useful for handling files created by programs that do
               not exactly follow the appropriate file format
               standard.

          ----AAAA   Create an AppleSingle archive.

          ----BBBB   Force translation of a BinHex archive.

          ----CCCC   Create a CAP/AUFS version 3 archive.

          ----DDDD   Create an AppleDouble archive.

          ----MMMM   Create a MacBinary archive.

          ----UUUU   Assume input infile is a IPT uShare file (uShare files
               are not automatically recognized as they lack an easy
               "magic" number to recognize).



     Page 2                                          (printed 5/4/100)






     KKKKUUUUNNNNAAAARRRRCCCC((((1111))))       KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))       KKKKUUUUNNNNAAAARRRRCCCC((((1111))))



          iiiinnnnffffiiiilllleeee
               This may be a directory (in which case all regular
               files in _i_n_f_i_l_e are processed).

     FFFFIIIILLLLEEEESSSS
           ./.HSancillary               File for additional file
                                        information needed by
                                        Macintosh.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
          _K_u_n_a_r_c can be run in batch mode in conjunction with _f_i_n_d.
          (You should run _k_u_n_a_r_c as root if you use this method).  If
          you are doing this, we suggest piping stdout into a log file
          so you can look at stderr for any errors. If you don't have
          a backup of your filesystem, we suggest you don't use the
          remove option if you use _k_u_n_a_r_c in batch mode. Instead, you
          can use another _f_i_n_d command to remove the archive files
          once _k_u_n_a_r_c has been run successfully. (See examples below).

          Convert all AppleDouble files in the directory tree rooted
          at /_u_s_r/_m_o_u_n_t to K-AShare format:

               find /usr/mount -name "%*" -exec kunarc {} \;

          Convert all A/UX files in the directory tree rooted at
          /_u_s_r/_m_o_u_n_t to K-AShare format:

               find /usr/mount -type d -name ".AppleDouble" -prune -exec kunarc {} \;

          If this succeeds without incident, use the following commands to remove
          the A/UX directories (which will no longer be necessary).

               find . -name ".AppleDouble" -prune -exec rm -r {} \;

          Convert all CAP-AUFS files in the directory tree rooted at
          /_u_s_r/_m_o_u_n_t to K-AShare format:

               find /usr/mount -type d -name ".finderinfo" -prune -exec kunarc {} \;

          If this succeeds without incident, use the following commands to remove
          the CAP directories (which will no longer be necessary).

               find . -name ".finderinfo" -prune -exec rm -r {} \;
               find . -name ".resource" -prune -exec rm -r {} \;

          Convert all TOPS files in the directory tree rooted at
          /_u_s_r/_m_o_u_n_t to K-AShare format:

                find . -name ".rsrc" -prune -o -type f -exec kunarc {} \;

          If this succeeds without incident, use the following commands to remove
          the TOPS directories (which will no longer be necessary).



     Page 3                                          (printed 5/4/100)






     KKKKUUUUNNNNAAAARRRRCCCC((((1111))))       KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))       KKKKUUUUNNNNAAAARRRRCCCC((((1111))))



               find . -name ".rsrc" -exec rm -rf {} \;

          Convert all Helios EtherShare files in the directory tree
          rooted at /_u_s_r/_m_o_u_n_t to K-AShare format:

                find . -name ".rsrc" -type d -exec kunarc {} \;

          Convert all IPT uShare files in the directory tree rooted at
          /_u_s_r/_m_o_u_n_t
          to K-AShare format:

                find . -name ".rsrc" -type d -exec kunarc -U {} \;

          You also need to change the directory names from Helios'
          or IPT's 8 bit character encoding scheme to Xinet's encoding scheme.
          This has to be done as a separate step as the find command gets confused
          when directories being searched change names.  Run kunarc with
          the -h flag at the root of the Helios EtherShare or IPT uShare
          directory tree:

               kunarc -h /usr/mount

          If all this succeeds without incident, use the following commands
          to remove the EtherShare or uShare directories (which will no longer
          be necessary).

               find . -name ".rsrc" -type d -exec rm -rf {} \;

          Convert all K-AShare files in the directory tree rooted at
          /_u_s_r/_m_o_u_n_t to AppleDouble format (type as one line):

               find /usr/mount \( -type d -name ".HSResource" -prune \)
                    -o \( -name ".HSancillary" \)
                    -o -type f -exec karc -D -r {} \;

          Convert _A_M_a_c_F_i_l_e into _u_u, which can be appended to messages
          sent to AppleLink accounts via the Internet AppleLink
          gateway (e.g. [e-mail]).  AppleLink will
          convert the enclosure back to the original Macintosh file.

               karc -A -f - AMacFile | uuencode AMacFile >! uu

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          _K-_A_S_h_a_r_e _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e

     BBBBUUUUGGGGSSSS
          The tolerant flag does not always work.

          If _k_u_n_a_r_c is used in conjunction with _f_i_n_d(_1) and the remove
          flag is on, _f_i_n_d may be confused when _k_u_n_a_r_c deletes files.
          This will result in spurious error messages (usually
          something like "cannot stat <filename>"), which may be



     Page 4                                          (printed 5/4/100)






     KKKKUUUUNNNNAAAARRRRCCCC((((1111))))       KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))       KKKKUUUUNNNNAAAARRRRCCCC((((1111))))



          ignored.

          _k_u_n_a_r_c doesnt do the right thing when given the dataforks
          for Helios EtherShare and IPT uShare files.  Give it the
          file in the .rsrc directories.

          _K_a_r_c supports only MacBinary, AppleSingle and AppleDouble.
















































     Page 5                                          (printed 5/4/100)